runtest

Section: User Commands (1)
Updated: 31 Dec 1992
Index Return to Main Contents
 

NAME

runtest - the DejaGnu test driver program  

SYNOPSIS

runtest [ options ]  

DESCRIPTION

DejaGnu is a framework for running test suites on GNU tools. It is written in expect, which uses TCL (Tool command language). runtest is the test driver program; use it to control what tests to run, and variations on how to run them.

You can find a comprehensive description of DejaGnu and runtest in The DejaGnu Testing Framework or its Info version, dejagnu.info.  

OPTIONS

--help
Prints out a help screen and then exits.
--baud  rate
Set the baud rate for a serial line connection. Some serial interface programs (like tip) don't use this value but instead use a separate initialization file.
--version, -V
Prints out the versions of DejaGnu, expect and Tcl.
--verbose, -v
Turns on more debugging output from test cases and DejaGnu utility code. Use more than once to increase output further.
--all
Print all test output to screen. By default, only unexpected results are displayed.
--diff file
Run diff on the summary of the current run and the previous run.
--debug
Turn on expect internal debugging output. All output is logged to a file called dbg.out. The output of the --strace also goes into this file.
--srcdir path
path is a directory containing test directories.
--objdir path
path is a directory containing compiled test code.
--strace N
Turns on expect internal tracing to N levels deep.
--host type
The configuration string for the host.
--target type
The configuration string for the host.
--name hostname
The network hostname of the target board.
--runtest 'file1 file2 ...'
The names of specific test files to run.
--tool toolname
Specify the tool to be tested. toolname controls the test suite applied, and the associated initialization module.
--outdir directory
The name of a directory for test log output.
--noreboot
Do not reboot the target board when runtest initializes.
--mail 'name1 name2 ...'
Electronic mail addresses to receive test results.
--connect type
The type of connection to use. The choices are rlogin, telnet, rsh, kermit, tip, mondfe.
Makefile style variables are used to specify tool names and their
flags; these and other configuration dependent values are saved in the file site.exp, created during configuration.
 

EXIT CODES

runtest sets the exit code to 1 if any of the tests failed, or sets it to 0 if all the tests passed.  

SEE ALSO

The DejaGnu Testing Framework (dejagnu.info). This is the DejaGnu manual; its source is the Texinfo file doc/dejagnu.texi in the DejaGnu distribution.  

AUTHOR

Rob Savoye (rob@cygnus.com)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT CODES
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 17:13:31 GMT, January 16, 2023